home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr09 / smrten19.zip / SMART10.TXT < prev    next >
Text File  |  1993-06-14  |  37KB  |  784 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                    Smart10  TM
  13.                            X10 Powerhouse Home Control
  14.                              CP290 Programming System
  15.  
  16.                                    version 1.9
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                    Users Guide
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                    ┌─────────┐
  32.              ┌─────┴───┐     │              (R)
  33.            ──│         │o    │──────────────────
  34.              │   ┌─────┴╨──┐ │  Association of
  35.              │   │         │─┘  Shareware
  36.              └───│    o    │    Professionals
  37.            ──────│    ║    │────────────────────
  38.                  └────╨────┘    MEMBER
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.      copyright 1991 Sympathetic Software
  47.  
  48.                           9531 Telhan Drive
  49.                           Huntington Beach, CA  92646
  50.                           USA
  51.  
  52.  
  53.  
  54.                                All Rights Reserved
  55.  
  56.  
  57.         June 14, 1993                Smart10 v1.9                      Page 1
  58.  
  59.                                   Table of Contents
  60.  
  61.         The Shareware Concept                                      2
  62.  
  63.         Support                                                    3
  64.  
  65.         Introduction                                               4
  66.  
  67.         Configuration                                              5
  68.  
  69.         Programming Your Events                                    7
  70.  
  71.         Command Line Parameters                                   10
  72.  
  73.         The CHKTIME Program                                       14
  74.  
  75.         The DSTIME Program                                        15
  76.  
  77.         Sample Files                                              15
  78.  
  79.         Change History                                            15
  80.  
  81.  
  82.         June 14, 1993                Smart10 v1.9                      Page 2
  83.  
  84.         The Shareware Concept
  85.  
  86.  
  87.              Shareware distribution gives users a chance to try software
  88.         before buying it.  If you try a Shareware program and continue using
  89.         it, you are expected to register.  Individual programs differ on
  90.         details - some request registration while others require it, some
  91.         specify a maximum trial period.  With registration, you get anything
  92.         from the simple right to continue using the software to an updated
  93.         program with printed manual.
  94.  
  95.              Copyright laws apply to both Shareware and commercial software,
  96.         and the copyright holder retains all rights, with a few specific
  97.         exceptions as stated below.  Shareware authors are accomplished
  98.         programmers, just like commercial authors, and the programs are of
  99.         comparable quality.  (In both cases, there are good programs and bad
  100.         ones!) The main difference is in the method of distribution.  The
  101.         author specifically grants the right to copy and distribute the
  102.         software, either to all and sundry or to a specific group.  For
  103.         example, some authors require written permission before a commercial
  104.         disk vendor may copy their Shareware.
  105.  
  106.              Shareware is a distribution method, not a type of software.  You
  107.         should find software that suits your needs and pocketbook, whether
  108.         it's commercial or Shareware.  The Shareware system makes fitting
  109.         your needs easier, because you can try before you buy.  And because
  110.         the overhead is low, prices are low also.  Shareware has the ultimate
  111.         money-back guarantee - if you don't use the product, you don't pay
  112.         for it.
  113.  
  114.              Smart10 is a "shareware program" and is provided at no charge to
  115.         the user for evaluation.  Feel free to share it with your friends,
  116.         but please do not give it away altered or as part of another system.
  117.         The essence of "user-supported" software is to provide personal
  118.         computer users with quality software without high prices, and yet to
  119.         provide incentive for programmers to continue to develop new
  120.         products.  If you find this program useful and find that you are
  121.         using Smart10 and continue to use Smart10 after a reasonable trial
  122.         period, you must make a registration payment of $20 to SYMPATHETIC
  123.         SOFTWARE.  The $20 registration fee will license one copy for use on
  124.         any one computer at any one time.  You must treat this software just
  125.         like a book.  An example is that this software may be used by any
  126.         number of people and may be freely moved from one computer location
  127.         to another, so long as there is no possibility of it being used at
  128.         one location while it's being used at another.  Just as a book cannot
  129.         be read by two different persons at the same time.
  130.  
  131.              Commercial users of Smart10 must register and pay for their
  132.         copies of Smart10 within 30 days of first use or their license is
  133.         withdrawn.  Site-License arrangements may be made by contacting
  134.         SYMPATHETIC SOFTWARE.
  135.  
  136.              Anyone distributing Smart10 for any kind of remuneration must
  137.         first contact SYMPATHETIC SOFTWARE.  This authorization will be
  138.         automatically granted to distributors recognized by the Association
  139.         of Shareware Professionals (ASP) as adhering to its guidelines for
  140.         shareware distributors, and such distributors may begin offering
  141.         Smart10 immediately (However SYMPATHETIC SOFTWARE must still be
  142.  
  143.  
  144.         June 14, 1993                Smart10 v1.9                      Page 3
  145.  
  146.         advised so that the distributor can be kept up-to-date with the
  147.         latest version of Smart10.).
  148.  
  149.              You are encouraged to pass a copy of Smart10 along to your
  150.         friends for evaluation.  Please encourage them to register their copy
  151.         if they find that they can use it.  All registered users will receive
  152.         a copy of the latest version of the Smart10 system including a
  153.         printed version of this manual.  To register your copy of Smart10,
  154.         send in a completed copy of the enclosed order form.
  155.  
  156.  
  157.         Support
  158.  
  159.  
  160.              The current version of Smart10 is available from the IBMHW forum
  161.         on CompuServ.  The file to download is SMRTEN.EXE.  Problem reports
  162.         may be made to Sympathetic Software or sent by CompuServ E-Mail to:
  163.  
  164.                   Stephen L Billard: 71046,1476
  165.  
  166.              This program is produced by a member of the Association of
  167.         Shareware Professionals (ASP).  ASP wants to make sure that the
  168.         shareware principle works for you.  If you are unable to resolve a
  169.         shareware-related problem with an ASP member by contacting the member
  170.         directly, ASP may be able to help.  The ASP Ombudsman can help you
  171.         resolve a dispute or problem with an ASP member, but does not provide
  172.         technical support for members' products.  Please write to the ASP
  173.         Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a
  174.         CompuServ message via CompuServ Mail to ASP Ombudsman 70007,3536.
  175.         The Ombudsman may be contacted by FAX by sending to the ASP FAX
  176.         number: (616) 788-2765.  In communications with the Ombudsman please
  177.         include a telephone number and/or FAX if available.
  178.  
  179.  
  180.         June 14, 1993                Smart10 v1.9                      Page 4
  181.  
  182.         Introduction
  183.  
  184.  
  185.              Smart10 is intended for use with the X10 Powerhouse CP290
  186.         computer interface.  This interface can be programmed from a personal
  187.         computer and will maintain and execute up to 128 timer events.  These
  188.         events can be set for specific times and days of the week.  The
  189.         controller has a span of only one week, and does not have the concept
  190.         of sunrise and sunset.  The software which comes with the controller
  191.         is somewhat clumsy to use if you wish to define more than a few
  192.         events.
  193.  
  194.              Smart10 was devised to overcome the limitations of the CP290 and
  195.         its supplied software.  It can maintain a year's calendar of events.
  196.         You can use SUNRISE and SUNSET as times.  (You don't have use them as
  197.         exact time, you can add or subtract time from them.)  Events can be
  198.         conditioned to occur (or not to occur) if it is DARK (or LIGHT) or if
  199.         they occur between dates you have specified.  You can also put
  200.         parameters on the command line and use them as conditions.
  201.  
  202.              There is an "immediate" command mode (run from the command line)
  203.         whereby you can issue direct or delayed commands and cancel pending
  204.         events.  Two programs are included to help you automate your
  205.         AUTOEXEC.BAT files.  These are CHKTIME and DSTIME.  CHKTIME compares
  206.         the computer's date and time with target date and times.  ERRORLEVEL
  207.         is set if there is a match.  DSTIME is used to adjust your computer
  208.         clock for daylight savings time.  With Smart10 and these programs you
  209.         can completely automate maintainence of your CP290.  (You can
  210.         automate other periodic functions as well.  See the examples below.)
  211.  
  212.              Smart10 operates from a control file which describes the modules
  213.         you have and the timer events you've scheduled.  The format of this
  214.         file and its instructions is described below.  However, you don't
  215.         need to know anything of its format to begin using Smart10.  If you
  216.         are already using the CP290 you have the initial starting point for
  217.         your home automation.  The program GENPGM will create a control file
  218.         for you describing the modules and events you are currently using.
  219.         Just modify this file to add the additional capabilities that Smart10
  220.         provides.
  221.  
  222.  
  223.         June 14, 1993                Smart10 v1.9                      Page 5
  224.  
  225.         Configuring Smart10
  226.  
  227.  
  228.              When Smart10 is first run, or when you use /C on the command
  229.         line, you will be presented with the Smart10 Registration screen and
  230.         the Smart10 configuration screen.  These screens are shown below.
  231.  
  232.              ┌───────────────────────────────────────────────────────────┐
  233.              │ Smart10 X10 Powerhouse Control Program                    │
  234.              │ Copyright 1991 by Sympathetic Software                    │
  235.              │                                                           │
  236.              │                    Registration Information               │
  237.              │                                                           │
  238.              │      Your Name:                                           │
  239.              │                                                           │
  240.              │      Registration ID:                                     │
  241.              │                                                           │
  242.              └───────────────────────────────────────────────────────────┘
  243.  
  244.         For now, type ESC to bypass the registration screen.  When you send
  245.         in your registration, you will get instructions on filling in this
  246.         screen.  (Note: if you do not type anything for 30 seconds, the
  247.         registration screen automatically goes away.  Once you have
  248.         registered Smart10, the screen will not be redisplayed.)
  249.  
  250.              ┌───────────────────────────────────────────────────────────┐
  251.              │ Smart10 X10 Powerhouse Control Program                    │
  252.              │ Copyright 1991 by Sympathetic Software                    │
  253.              │                                                           │
  254.              │                    Configuration Information              │
  255.              │                                                           │
  256.              │      House Code: A                                        │
  257.              │                                                           │
  258.              │      Latitude: 33° 48' 0" N                               │
  259.              │                                                           │
  260.              │      Longitude: 117° 54' 0" W                             │
  261.              │                                                           │
  262.              │      Time Zone: PACIFIC                                   │
  263.              │                                                           │
  264.              │      Do you observe Daylight Savings time? (Y/N) Y        │
  265.              │                                                           │
  266.              │      Confirm time override? (Y/N) N                       │
  267.              │                                                           │
  268.              │      Synchronize CP290 to the minute? (Y/N) N             │
  269.              │                                                           │
  270.              │      The CP290 is attached to: COM1                       │
  271.              │                                                           │
  272.              └───────────────────────────────────────────────────────────┘
  273.  
  274.  
  275.              You should set House Code to the House Code you wish the CP290
  276.         to use when one of its eight rocker switches is activated.  Set the
  277.         Latitude and Longitude to your location.  You do not need to be very
  278.         precise with these.  They are used in computing Sunrise and Sunset
  279.         times.  The location of any nearby major city will probably be close
  280.         enough.  (The file LOCATION.TXT contains a list of cities and their
  281.         latitudes and longitudes.)  Time Zone should be set to your time
  282.         zone.  Smart10 will offer a default based on your longitude.  You
  283.  
  284.  
  285.         June 14, 1993                Smart10 v1.9                      Page 6
  286.  
  287.         will have to correct this if you live near an irregularity of the
  288.         time zone line.  If you live in an area which does not observe
  289.         Daylight Savings time then you should answer N (for No) to the
  290.         Daylight Savings time question.  Otherwise answer Y (for Yes).
  291.  
  292.              If you set Confirm time override to Y, Smart10 will ask you for
  293.         confirmation if the computer's time differs from the time kept by the
  294.         CP290 by more than about five minutes.  As long as you trust your
  295.         computer's clock you should configure this as N.  The CP290's clock
  296.         will then be set to the computer's time.  This is specially important
  297.         if you are going to automatically load the CP290 in the middle of the
  298.         night.
  299.  
  300.              The CP290's time setting accuracy is only within a minute.  In
  301.         other words, it cannot be set to a particular second.  Thus, unless
  302.         the computer waits until its clock is an even minute before setting
  303.         the CP290, its time may be off by many seconds.  The Synchronize
  304.         CP290 to the minute option causes Smart10 to wait until the computer
  305.         clock is at an even minute before setting the CP290 clock.  The
  306.         downside of this option is the extra time it takes to wait for an
  307.         even minute.
  308.  
  309.              You may select any serial port to attach your CP290.  Enter COM1
  310.         for the first serial port, COM2 for the second.  If you have a non
  311.         standard IO base address for your serial port, you may the address
  312.         instead of COM1 or COM1.  The address must be entered in hexidecimal
  313.         (e.g.. 3F8 for COM1.)
  314.  
  315.              The configuration is stored permanently in the SMART10.INI file.
  316.         This file will be located in the directory which contains the Smart10
  317.         program.  Although this file is stored in a display format, you
  318.         should not attempt to modify its contents.  Use the reconfiguration
  319.         feature of Smart10 to change its configuration.
  320.  
  321.  
  322.         June 14, 1993                Smart10 v1.9                      Page 7
  323.  
  324.         Programming Your Events
  325.  
  326.  
  327.              You describe your timer events to Smart10 by providing it a
  328.         module/event file.  This file is normally called X10.PGM.  (It is
  329.         possible to use any file name.  X10.PGM is the default.)  This file
  330.         contains a series of Module Identifications and associated Module
  331.         Events.
  332.  
  333.              The GENPGM program is included to make it easier for you to get
  334.         started using Smart10.  If you already have modules and events stored
  335.         in your CP290 then creating a module/event file for Smart10 is just a
  336.         matter of running GENPGM.  GENPGM needs to read the X10.DAT file that
  337.         the software which comes with your CP290 creates.  This file must be
  338.         in the currently logged on directory when you run GENPGM.  (That is,
  339.         you must CD to the directory which has this file.  Most likely this
  340.         is the \X10 directory.)  If the X10.DAT file is not available, GENPGM
  341.         will not have the module names for your modules.  It will make up
  342.         names for them.
  343.  
  344.              When you run GENPGM it will ask for the COM port where your
  345.         CP290 is attached.  Enter the appropriate COM port or the hex IO
  346.         address if your port does not use the standard addresses.  GENPGM
  347.         will write GENX10.PGM.  This file will be a module/event file which
  348.         reproduces the modules and events you are currently running.  Use
  349.         this file as a starting point.  Edit with any ASCII text editor and
  350.         turn it into a description of how you want to run your house.  (You
  351.         should rename the edited file X10.PGM so that Smart10 will use it as
  352.         the default program.)
  353.  
  354.              The Smart10 module/events program file consists of a series of
  355.         Module Identification headings and the module's associated events.
  356.         Module Identifications and Module Events must be wholly contained on
  357.         one line.  You may include commentary (which may be multiple lines)
  358.         by enclosing it within braces ("{" and "}").
  359.  
  360.              A Module Identification identifies the X10 unit you wish to
  361.         control.  A Module Identification consists of a Location and
  362.         Description separated by a colon (":") followed
  363.  
  364.  
  365.         June 14, 1993                Smart10 v1.9                      Page 8
  366.  
  367.         by a crosshatch ("#") or asterisk ('*') and the House Code and Unit
  368.         number of the module.  Example:
  369.  
  370.                 Master bedroom : Light switch #A5
  371.                 Study : Computer *B1
  372.  
  373.         The text you provide for the Location and Description are written to
  374.         the X10.DAT file used by the software which comes with the CP290.
  375.         They are also optionally displayed by Smart10 when it is loading the
  376.         CP290.  They can be any text (exclusive of a colon, crosshatch, or
  377.         asterisk.)  The house and unit codes should match the setting on the
  378.         X10 module.
  379.  
  380.              Crosshatch is the normal prefix for the House Code and Unit
  381.         number.  Asterisk is used when you do not want the power fail restore
  382.         function to set the module to its current programmed state.  (For
  383.         instance, if the latest event for the Study Computer was off, you
  384.         would not want the power fail restore function to turn if off as the
  385.         restore was executing.)
  386.  
  387.              It is possible to have a Module Identification refer to more
  388.         than one unit within a House Code.  In this case, the module events
  389.         will effect all the units identified by the Module Identification.
  390.         To specify multiple unit codes, Concatenate the additional unit codes
  391.         with either an ampersand (&) or an ellipsis (..).  Example:
  392.  
  393.              Emergency Lights: Living Areas *A1&4
  394.  
  395.              All Lights: Whole House *B1..16
  396.  
  397.              Some Lights: Livingroom *C3..5&8
  398.  
  399.         Ampersands are used to indicate single units.  Ellipses are used to
  400.         indicate a series of units.  For the first example, module events
  401.         will turn on and off modules A1 and A4.  Module events for the second
  402.         example will effect modules B1, B2, B3, B4, B5, B7, B8, B9, B10, B11,
  403.         B12, B13, B14, B15 and B16.  The third example controls modules C3,
  404.         C4, C5 and C8.
  405.  
  406.              The software which comes with the CP290 does not support
  407.         multiple unit Module Identifications.  Thus, if you use the X10
  408.         program to review your events you will not see any these modules and
  409.         events.  Also note that these Module Identifications do not appear in
  410.         the Module Map.
  411.  
  412.              A Module Event consists of a command, time, optional condition,
  413.         and the days the event should be activated.  The Module Event
  414.         commands are ON, OFF, and DIM.  (These may be proceeded with CANCEL
  415.         if you are deactivating an event.)  Times may be absolute or security
  416.         mode, and can be expressed in military time or civilian time.  You
  417.         may also use SUNSET, SUNRISE, or NOW as a time.  These latter may be
  418.         modified by adding or subtracting a time value.  CANCEL and NOW are
  419.         most useful in command line event setting.  See below.
  420.  
  421.              There may be any number of Module Events following a Module
  422.         Identification.  The only constraint it that the CP290 can manage
  423.         only 128 events.  Examples of Module Events:
  424.  
  425.  
  426.         June 14, 1993                Smart10 v1.9                      Page 9
  427.  
  428.                 ON @ 2300 EVERYDAY
  429.                 OFF ~ 10:00pm SATURDAY
  430.                 DIM 70% @ SUNSET + 0:10 WEEKDAYS
  431.  
  432.         The At sign ("@") is used when the time is absolute.  The tilde ("~")
  433.         is used to specify approximate (security mode) time.  For security
  434.         mode time, the event is set randomly to within 15 minutes of the time
  435.         value given.  The CP290 will randomly vary this time each day as
  436.         well.
  437.  
  438.              The days the event is to be activated is either TODAY, TOMORROW,
  439.         EVERYDAY, DAILY, or a list of the actual days.  You can use WEEKENDS
  440.         in place of SATURDAY SUNDAY and you can use WEEKDAYS in place of
  441.         MONDAY TUESDAY WEDNESDAY THURSDAY FRIDAY.  These names can be
  442.         abbreviated.  Examples of activation days:
  443.  
  444.                 ON @ 0400 SUN MON
  445.                 OFF @ 11:45pm DAILY
  446.                 DIM 30 % @ SUNRISE - 2:00 FRI WEEKENDS
  447.                 OFF NOW+0:20 TODAY
  448.  
  449.         TODAY and TOMORROW have special meaning to the CP290.  These events
  450.         occur only once.  The CP290 clears them once the day has past.
  451.  
  452.              You can use a specific date in place of an activation day list.
  453.         An example of this is:
  454.  
  455.                 ON @ 1700 ON 7/4
  456.  
  457.              There are two modifiers which can be used to control when an
  458.         event will be active.  It may be active only between certain dates,
  459.         or it may be active only when a condition is met.  An example of the
  460.         former is:
  461.  
  462.                 ON @ SUNSET + 0:30 BETWEEN 11/15 AND 12/1
  463.  
  464.         A condition may be DARK, LIGHT, EARLIERTHAN a time, LATERTHAN a time,
  465.         or it may be a character string.  When the condition is a character
  466.         string, it is true if the character string is a parameter on the
  467.         command line when Smart10 is run.  Otherwise it is false.  (The
  468.         character strings may not contain blanks or other special
  469.         characters.)
  470.  
  471.  
  472.         June 14, 1993                Smart10 v1.9                     Page 10
  473.  
  474.         The condition may also be an expression involving NOT, AND, OR, and
  475.         parenthesis.  Some examples are:
  476.  
  477.                 OFF ~ 11:00pm IF DARK AND NOT (OUT OR VISITORS) SAT
  478.  
  479.                 ON @ Sunset IF EARLIERTHAN 7:00 PM EVERYDAY
  480.  
  481.         You may use ampersand ("&") for AND and bar ("|") for OR.  A Module
  482.         Event may have both a condition and a date modifier.  Example:
  483.  
  484.                 ON @ 2100 IF OUT | NOT VISITORS SAT BETWEEN 1/12 AND 3/3
  485.  
  486.              The X10 software which came with your CP290 has an anomaly with
  487.         its DIM function.  The X10 system allows for 16 levels of DIM from
  488.         fully bright to fully dim.  The X10 software allows only nine levels
  489.         (from 90% to 10%.)  It assigns (rather arbitrarily) dim levels to
  490.         these nine steps.  Any intermediate value the X10 software finds is
  491.         reported as 90% dim no matter what its real value is.  If you use the
  492.         X10 software to review dim values set by Smart10 you will not get
  493.         correct reporting.
  494.  
  495.              The CP290 can not deal with anything more complex than day of
  496.         the week.  For the above events to work, you must run Smart10 at
  497.         least once a week.  This allows the program to load the events for
  498.         the week.  You must also re-run Smart10 if one of the character
  499.         string conditions needs to be changed.  The program can optionally
  500.         display the events which are active for the week as it loads the
  501.         CP290 to show you what has been selected.
  502.  
  503.              Automatically loading the CP290 once a week is a simple task if
  504.         you use an X10 module to turn on and off your computer.  You can set
  505.         an event to turn on the computer once a week and use the CHKTIME
  506.         program in your AUTOEXEC.BAT file to run Smart10 when the computer is
  507.         automatically powered on.  For instance, for your computer have a
  508.         Module Event as follows:
  509.  
  510.                 Office:Computer #A1
  511.                     ON @ 3am SUNDAY
  512.  
  513.         And in your AUTOEXEC.BAT file have:
  514.  
  515.                 CHKTIME SUN 03000
  516.                 IF ERRORLEVEL 1 GOTO SETEVENTS
  517.                 .
  518.                 .
  519.                 .
  520.                 :SETEVENTS
  521.                 Smart10
  522.                 Smart10 /S A1 OFF
  523.  
  524.         This would turn the computer on at 3am each Sunday.  The batch file
  525.         would check to see if it was 3am, and if so would execute Smart10 to
  526.         load the X10.PRG file into the CP290.  Then it uses Smart10 to send
  527.         an immediate command to turn the computer off.
  528.  
  529.  
  530.         June 14, 1993                Smart10 v1.9                     Page 11
  531.  
  532.         Command Line Parameters to Smart10
  533.  
  534.  
  535.         Loading a file other than X10.PGM:
  536.  
  537.              Run Smart10 with the command line parameter /F:filename.
  538.         Smart10 will read filename to get the Module Descriptions and Module
  539.         Events to load into the CP290. The CP290 is cleared before the events
  540.         are loaded.  Example:
  541.  
  542.                 Smart10 /F:vacation.sch
  543.  
  544.         Adding events to a CP290 program
  545.  
  546.              Run Smart10 with the command line parameter /A:filename.
  547.         Smart10 will read filename to get the Module Descriptions and Module
  548.         Events to be added to the events loaded in the CP290.  The difference
  549.         between loading events with the /A parameter and loading from the
  550.         default file or from a file named via the /F parameter is that the
  551.         CP290 is not cleared first.  This means that the events described in
  552.         filename are added to the events already loaded in the CP290.
  553.         Example:
  554.  
  555.                 Smart10 /A:oneshot
  556.  
  557.         The file loaded might contain a lawn sprinkler program with events
  558.         defined for TODAY.  You would run Smart10 to add these events to the
  559.         CP290 when the lawn needs watering.  Since the events are defined for
  560.         TODAY, the CP290 will clear them out once they are done.
  561.  
  562.         Reconfiguring Smart10:
  563.  
  564.              Run Smart10 with the command line parameter /C.  This will cause
  565.         Smart10 to present you with the configuration screen.  (See page 5
  566.         for configuring Smart10.)  Example:
  567.  
  568.                 Smart10 /C
  569.  
  570.         Resetting all modules after a power failure:
  571.  
  572.              Run Smart10 with the command line parameter /R.  Smart10 will
  573.         load the CP290 from your Description-Event file and set each module
  574.         to the state it would be if the power had not failed.  Modules which
  575.         use asterisk in place of crosshatch for the house code-unit number
  576.         prefix are omitted from this power fail restore.  Example:
  577.  
  578.                 Smart10 /R
  579.  
  580.         Display the event commands being loaded to the CP290
  581.  
  582.              Run Smart10 with the command line parameter /E and it will
  583.         display each event as it is loaded into the CP290.  (An events which
  584.         is not active either because its condition is false or because the
  585.         current date is out of range with its date range will not be shown.)
  586.  
  587.                 Smart10 /E
  588.  
  589.  
  590.         June 14, 1993                Smart10 v1.9                     Page 12
  591.  
  592.         will display the active events.  You can direct the output of this
  593.         option to a file or the printer by adding a colon and the file name
  594.         to the parameter.
  595.  
  596.                 Smart10 /E:EVENTS.LOG
  597.  
  598.         will write the active events to the file EVENTS.LOG.
  599.  
  600.                 Smart10 /E:LPT1
  601.  
  602.         will write the active events to the printer.
  603.  
  604.         Print out a module map:
  605.  
  606.              Run Smart10 with the command line parameter of Smart10 /M to
  607.         display a map of the X10 modules you have defined in your
  608.         module/event program.
  609.  
  610.                 Smart10 /M
  611.  
  612.         will display the module map.  As with Events, you can direct the
  613.         output of this option to a file or the printer by adding a colon and
  614.         the file name to the parameter.
  615.  
  616.                 Smart10 /M:LPT1
  617.  
  618.         will print a list of module locations and descriptions and their
  619.         module house and unit codes.
  620.  
  621.  
  622.         June 14, 1993                Smart10 v1.9                     Page 13
  623.  
  624.         Send a module control command from your computer:
  625.  
  626.              Run Smart10 with the command line parameter /S Module-ID
  627.         Module-Event.  Module-ID is any House Code Unit Code pair.
  628.         Module-Event is as described for the Description-Event file.  In
  629.         addition, you may use a simple ON, OFF, or DIM command with no time,
  630.         etc.  This is equivalent of a time of NOW.  You may omit the day list
  631.         as well.  Then the event is set for Today or Tomorrow depending on
  632.         the time value.  (If you select a time greater then midnight and less
  633.         then NOW, then the event is set for Tomorrow.  You might do this by
  634.         using NOW + 23:00 or NOW -1:00.)  These events are one time
  635.         occurrences.  The CP290 will discard the event once the day has past.
  636.         If you use the /S parameter, the rest of the command line is assumed
  637.         to be the Module ID and Module Event.  Examples:
  638.  
  639.                 Smart10 /S A1 OFF
  640.                 Smart10 /S A2 CANCEL OFF @ 3:15am SUN
  641.                 Smart10 /S A3 OFF NOW + 0:10
  642.  
  643.         Events which are scheduled to occur within a minute of the current
  644.         time are issued as direct commands by Smart10.  Others are loaded as
  645.         one time events for Today or Tomorrow.
  646.  
  647.              I use OFF NOW + 0:05 to turn off my computer when it has
  648.         finished doing my backups.  The extra five minutes gives the tape
  649.         drive a chance to rewind.
  650.  
  651.         Setting conditions from the command line:
  652.  
  653.              Any character string not started with a slash ("/") and not
  654.         including a blank is noted as a condition by Smart10.  Conditions can
  655.         be tested in Module Events.  A condition is TRUE if it appears on the
  656.         Smart10 command line.
  657.  
  658.  
  659.         June 14, 1993                Smart10 v1.9                     Page 14
  660.  
  661.         Otherwise it is FALSE.  Examples of command line conditions:
  662.  
  663.                 Smart10 SomeoneIsOut GuestsAreStaying
  664.                 Smart10 MichaelIsHome
  665.  
  666.         The case of the condition is ignored.  MichaelIsOut is the same as
  667.         MICHAELISOUT.
  668.  
  669.              You may have combinations of the above parameters on the command
  670.         line.  Of course, if you use /S, it must be the last command line
  671.         function.  Example:
  672.  
  673.                 Smart10 MichaelIsHome /R /E
  674.  
  675.         If you have a /S command, Smart10 will not read and process the
  676.         Description-Event file.
  677.  
  678.  
  679.         CHKTIME
  680.  
  681.  
  682.              CHKTIME compares the computer date and time with command line
  683.         target date-times.  If the computer date-time is within plus or minus
  684.         15 minutes of a target time, the DOS ERRORLEVEL value is set to
  685.         indicate the match.  If no targets match, ERRORLEVEL is set to 0.
  686.         The targets are compared from left to right as they appear on the
  687.         command line.  If the first target matches, ERRORLEVEL is set to 1.
  688.         If the second matches, ERRORLEVEL is set to 2, etc.  If multiple
  689.         targets match, ERRORLEVEL is set to the value for the first target
  690.         which matches.
  691.  
  692.              The sensitivity value (15 minutes) may be changed by adding a
  693.         slash ("/") parameter to the command line.  The parameter /0:20
  694.         changes the sensitivity value to 20 minutes.  You may set more than
  695.         one sensitivity value.  The value applies to all target times to its
  696.         right on the command line.
  697.  
  698.              Target times can be one of: a simple time-3:00AM; a day of the
  699.         week and time-SAT 1230; a month  day of the week  time-AUGUST 23
  700.         6:15PM; an ordinal number (optionally with a month)  time-2ND 0800,
  701.         1ST NOVEMBER 4:45AM; an ordinal number  day of the week (and
  702.         optionally IN month)  time-2ND SUNDAY 1900, 3rd SUNDAY IN JANUARY
  703.         5:45pm.  LAST may be used as an ordinal number to signify the last
  704.         day in the month.  If months are left out, then the current month is
  705.         assumed.  Examples
  706.  
  707.                 CHKTIME SUN 0300, 1ST SUN IN APR 0300, LAST SUN IN OCT 0300
  708.                 CHKTIME 1ST 3AM, SEPTEMBER 11 5PM
  709.  
  710.         The first example looks for 3am on Sundays.  If it happens on the
  711.         first Sunday in April (daylight savings time starts) then ERRORLEVEL
  712.         is set to 2.  If it happened on the last Sunday in October (daylight
  713.         savings time ends) then ERRORLEVEL is set to 3.  On any other Sunday
  714.         at 3am ERRORLEVEL will be set to 1.  You can use this example to
  715.         automate changing your computer clock for daylight savings time and
  716.         then setting events in the CP290.  Your AUTOEXEC.BAT file would look
  717.         like the following:
  718.  
  719.  
  720.         June 14, 1993                Smart10 v1.9                     Page 15
  721.  
  722.                 CHKTIME SUN 0300, 1ST SUN IN APRIL 0300, LAST SUN IN OCT 0300
  723.                 IF ERRORLEVEL 3 GOTO DSTOFF
  724.                 IF ERRORLEVEL 2 GOTO DSTON
  725.                 IF ERRORLEVEL 1 GOTO SETEVENTS
  726.                 GOTO NOTTIME
  727.                 :DSTOFF
  728.                 rem "Fall back" on the last Sunday in October
  729.                 DSTIME OFF
  730.                 GOTO SETEVENTS
  731.                 :DSTON
  732.                 rem "Spring forward" on the 1st Sunday in April
  733.                 DSTIME ON
  734.                 :SETEVENTS
  735.                 Smart10
  736.                 Smart10 /s A1 off
  737.                 :NOTTIME
  738.  
  739.         The DSTIME program
  740.  
  741.  
  742.              The DSTIME program is used to add or subtract an hour from your
  743.         computer's clock.  You can use it to automate changing the clock when
  744.         Daylight Savings time
  745.  
  746.              changes.  DSTIME ON sets the clock forward one hour and DSTIME
  747.         OFF sets it back one hour.
  748.  
  749.  
  750.         Example files
  751.  
  752.  
  753.              An example autoexec batch file and Smart10 module/event program
  754.         file have been included with this distribution.  These files
  755.         illustrate the topics described in this document.
  756.  
  757.  
  758.         Change History:
  759.  
  760.  
  761.         1.0  Original Release
  762.         1.1  Corrected CHKTIME problem with "LAST"
  763.              Corrected SMART10 problem with cancel
  764.              Corrected GENPGM problem with DIM values
  765.              Corrected handling of IF expressions using "|', "&" and Parens
  766.         1.2  Added EARLIERTHAN and LATERTHAN conditions
  767.         1.3  Added multiple unit Module Identifications
  768.              Fixed error in registration code
  769.         1.4  Added the INI file for configuration parameters
  770.              Fixed handling of BETWEEN which wraps year end
  771.         1.5  Cleaned up syntax checking on Module line
  772.              Enhanced GENPGM to handle multi-events, Unknown modules
  773.              Added verbage on what Smart10 is doing
  774.         1.6  Reclaimed dead event slots
  775.         1.7  Fixed random failure of Daylight Savings Time
  776.         1.8  Added file output option for Map and Event displays
  777.              Added Clock synchronization to the second
  778.              Corrected syntax parsing on missing day specification
  779.  
  780.  
  781.         June 14, 1993                Smart10 v1.9                     Page 16
  782.  
  783.              Fixed problems with Restore and multi-events
  784.         1.9  Fixed problems with NOW on immediate commands